After completing this lesson, you’ll be able to:
Sven has created a workspace that converts his data from Excel to geodatabase. However, before he finishes working on this workspace, Sven needs to add bookmarks and annotations. Bookmarks and annotations provide documentation for your workspace. If you have any experience programming, documenting your workspace is like commenting or documenting your code. These steps ensure that if your primary FME author goes on vacation or leaves the company, documentation will help the next FME author maintain, troubleshoot, and expand your organization's FME workspaces.
As a first step, Sven will use bookmarks to describe sections of his workspace. Bookmarks help you organize your workspace into logical sections. They make it easier to tell at a glance what each workspace section is doing. They also have advanced functionality useful when working with large workspaces, such as zooming to a particular bookmark or collapsing bookmarks to reduce visual clutter.
Sven opens FME Workbench (2024.0 or later) and adds two bookmarks to his workspace to surround his reader and writer feature types. He does this by selecting all the feature types he wants to include in a bookmark.
Then, he clicks on Bookmark in the toolbar.
You can also use the CTRL key (⌘ or Shift on Mac) + B .
After clicking the button, his feature types are surrounded by the colored bookmark. He can then type in a name. He names the Excel reader feature type bookmark “Public Art.”
Then, he adds another bookmark around the BusinessOwners and PublicArt writer feature types and names it “Output.”
His workspace now looks like this:
He also wants to add a note to describe what formats the workspace reads. To do this, he adds an annotation by right-clicking on the BusinessOwners reader feature type and then clicking Attach Annotation or pressing CTRL key (⌘ or Shift on Mac) + K (for "Komment," if you speak German!). He edits it to say: “Excel business licenses spreadsheet.”
This annotation makes it easy to see the data the workspace reads and writes. He repeats the process for his other reader feature types, resizing his bookmarks by clicking and dragging their edges as needed.
Make sure you have followed along with Sven’s steps.